Skip to content

added RELEASE.md and CONTRIBUTING.md files#420

Merged
mkopcins merged 5 commits intomainfrom
@mkopcins/repo-upkeep
Jul 2, 2025
Merged

added RELEASE.md and CONTRIBUTING.md files#420
mkopcins merged 5 commits intomainfrom
@mkopcins/repo-upkeep

Conversation

@mkopcins
Copy link
Copy Markdown
Collaborator

Description

Add RELEASE.md na CONTRIBUTING.md files.

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update (improves or adds clarity to existing documentation)

Tested on

  • iOS
  • Android

Testing instructions

Screenshots

Related issues

Checklist

  • I have performed a self-review of my code
  • I have commented my code, particularly in hard-to-understand areas
  • I have updated the documentation accordingly
  • My changes generate no new warnings

Additional notes

@mkopcins mkopcins requested review from chmjkb and pweglik June 26, 2025 09:42
@mkopcins mkopcins marked this pull request as draft June 26, 2025 09:43
Comment thread CONTRIBUTING.md
@mkopcins mkopcins force-pushed the @mkopcins/repo-upkeep branch from de93392 to f0a213e Compare June 26, 2025 10:14
Comment thread RELEASE.md Outdated
Comment thread RELEASE.md Outdated
@mkopcins mkopcins marked this pull request as ready for review June 30, 2025 10:30
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread RELEASE.md
@mkopcins mkopcins force-pushed the @mkopcins/repo-upkeep branch from b426521 to 1b91fc8 Compare June 30, 2025 11:03
Copy link
Copy Markdown
Contributor

@pweglik pweglik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, but it's important piece of docs - force one more person to read through it

@msluszniak
Copy link
Copy Markdown
Member

msluszniak commented Jun 30, 2025

Two additions from my side to RELEASE.md:

  • Mention adding promo material like video if applicable to README.md, for this version this was forgotten aka Add new video to README #332
  • Add info to change VERSION_TAG in model url constants. I created a PR which have introduced such tag. @pweglik in one PR added models that are introduced with version tag for currently developed version aka 0.5.0. As a consequence, I probably introduce something like NEXT_DEV_VERSION_TAG in rebasing the PR. These will need to be changed once published a new version. I can add this one separately once rebase and push my PR.

And there is a typo in PR title: REALESE.md -> RELEASE.md ;)

Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md
Comment on lines +21 to +34
## Feature request

Have an idea or is there a feature you would like to see added? Feel free to create a PR from a fork 😉. Alternatively if you don't have time for that just create a `🚀 Feature request` issue and fill in the necessary information.
The most important things to include are:

1. What is the motivation behind it? Is it something that is missing but is present in another library? Or maybe you need something more specific for your use case? Or just an idea that popped into your head?
We'd love to hear about this!

2. Describe it - add as much detail as you can. This helps to avoid any miscommunication problems and helps us to better understand it.

3. Provide a code snippet with the example usage (optional).

4. If there is a similar feature somewhere else drop a link (optional).

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we should also mention here that it is not restricted to features but also new model support to kind of let people know that we'd like to see what they need in terms of model coverage, but feel free to ignore though

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought this is somewhat contained in the ways-to-contribute/Export-new-models-to-ET-format section, but I can write it here explicitely

Comment thread CONTRIBUTING.md Outdated
Comment on lines +46 to +47
If you found some inconsistencies in our documentation or just something is missing just open a PR with suggested changes (remember to add changes to previous docs versions too).

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remember to add changes to previous docs versions too). I'm not sure if this will be understandable for someone who doesn't know this codebase

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We may change it to

Suggested change
If you found some inconsistencies in our documentation or just something is missing just open a PR with suggested changes (remember to add changes to previous docs versions too).
If you found some inconsistencies in our documentation or just something is missing just open a PR with suggested changes (remember to add changes to previous docs versions, in `versioned_docs` directory, too).

Comment thread RELEASE.md Outdated
4. Commit with a message 'Release v{MAJOR}.{MINOR}.0'. (We want to keep the latest `MINOR` version on the `main` branch.)
5. Create a new branch release branch `release/{MAJOR}.{MINOR}`and push it to the remote.
6. Stability tests are performed on the release branch and all fixes to the new-found issues are pushed into the main branch and cherry-picked into the release branch. This allows for further development on the main branch without interfering with the release process.
7. Once all tests are passed, tag the release branch with proper version tag `v{MAJOR}.{MINOR}.0` and run `npm publish`.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is confusing, what tests are you referring to?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since we don't have any automated tests right now and the only testing we do is test apps before release that's what I mean. In the future we should for sure add testing to the pipeline, at least for releases and maybe in the PRs. Also this is only for our internal use really

@mkopcins mkopcins changed the title added REALESE.md and CONTRIBUTING.md files added RELEASE.md and CONTRIBUTING.md files Jun 30, 2025
Mateusz Kopciński added 2 commits June 30, 2025 14:46
@mkopcins mkopcins merged commit 849056b into main Jul 2, 2025
2 checks passed
@mkopcins mkopcins deleted the @mkopcins/repo-upkeep branch July 2, 2025 08:17
mkopcins added a commit that referenced this pull request Oct 15, 2025
## Description

Add RELEASE.md na CONTRIBUTING.md files.

### Type of change

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [x] Documentation update (improves or adds clarity to existing
documentation)

### Tested on

- [ ] iOS
- [ ] Android

### Testing instructions

<!-- Provide step-by-step instructions on how to test your changes.
Include setup details if necessary. -->

### Screenshots

<!-- Add screenshots here, if applicable -->

### Related issues

<!-- Link related issues here using #issue-number -->

### Checklist

- [ ] I have performed a self-review of my code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have updated the documentation accordingly
- [ ] My changes generate no new warnings

### Additional notes

<!-- Include any additional information, assumptions, or context that
reviewers might need to understand this PR. -->

---------

Co-authored-by: Mateusz Kopciński <mateusz.kopcinski@swmansnion.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants